Node / meshtastic / Meshtastic-Android / files / feature / node / src / commonMain / kotlin / org / meshtastic / feature / node / component / AirQualityMetrics.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.feature.node.component

Tff7b72import T7ee787androidx.compose.runtime.Composable

Tff7b72import T7ee787androidx.compose.runtime.remember

Tff7b72import T7ee787androidx.compose.ui.graphics.Color

Tff7b72import T7ee787androidx.compose.ui.graphics.vector.ImageVector

Tff7b72import T7ee787org.jetbrains.compose.resources.StringResource

Tff7b72import T7ee787org.jetbrains.compose.resources.stringResource

Tff7b72import T7ee787org.meshtastic.core.common.util.NumberFormatter

Tff7b72import T7ee787org.meshtastic.core.common.util.nowSeconds

Tff7b72import T7ee787org.meshtastic.core.model.Node

Tff7b72import T7ee787org.meshtastic.core.model.util.AirQualityIndex

Tff7b72import T7ee787org.meshtastic.core.model.util.UnitConversions.toTempString

Tff7b72import T7ee787org.meshtastic.core.resources.Res

Tff7b72import T7ee787org.meshtastic.core.resources.aqi

Tff7b72import T7ee787org.meshtastic.core.resources.aqi_value_with_severity

Tff7b72import T7ee787org.meshtastic.core.resources.co2

Tff7b72import T7ee787org.meshtastic.core.resources.co2_humidity

Tff7b72import T7ee787org.meshtastic.core.resources.co2_temperature

Tff7b72import T7ee787org.meshtastic.core.resources.micrograms_per_cubic_meter

Tff7b72import T7ee787org.meshtastic.core.resources.pm10

Tff7b72import T7ee787org.meshtastic.core.resources.pm1_0

Tff7b72import T7ee787org.meshtastic.core.resources.pm2_5

Tff7b72import T7ee787org.meshtastic.core.resources.ppm

Tff7b72import T7ee787org.meshtastic.core.ui.component.Co2Severity

Tff7b72import T7ee787org.meshtastic.core.ui.component.PmAqiSeverity

Tff7b72import T7ee787org.meshtastic.core.ui.icon.AirQuality

Tff7b72import T7ee787org.meshtastic.core.ui.icon.Humidity

Tff7b72import T7ee787org.meshtastic.core.ui.icon.MeshtasticIcons

Tff7b72import T7ee787org.meshtastic.core.ui.icon.Temperature

Tff7b72import T7ee787org.meshtastic.feature.node.model.VectorMetricInfo

Tff7b72import T7ee787org.meshtastic.proto.AirQualityMetrics

Tff7b72import T7ee787org.meshtastic.proto.Telemetry

T8b949e/** Computes the EPA NowCast AQI (value + severity) from [pm25History], or null if there isn't enough data yet. */

Tff7b72private Tff7b72fun Td2a8ffnowCastAqiTb4b4b4(Te6edf3pm25HistoryTb4b4b4: Te6edf3ListTff7b72<Te6edf3TelemetryTff7b72>Tb4b4b4)Tb4b4b4: Te6edf3PairTff7b72<Tffa657IntTb4b4b4, Te6edf3PmAqiSeverityTff7b72>Tff7b72? Tb4b4b4{

Tff7b72val Te6edf3readings Tff7b72=

Te6edf3pm25HistoryTb4b4b4.Te6edf3mapNotNull Tb4b4b4{ Te6edf3telemetry Tff7b72-Tff7b72>

Te6edf3telemetryTb4b4b4.Te6edf3air_quality_metricsTff7b72?.Te6edf3pm25_standardTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3telemetryTb4b4b4.Te6edf3timeTb4b4b4.Te6edf3toLongTb4b4b4(Tb4b4b4) Te6edf3to Tffa657itTb4b4b4.Te6edf3toDoubleTb4b4b4(Tb4b4b4) Tb4b4b4}

Tb4b4b4}

Tff7b72val Te6edf3nowCastPm25 Tff7b72= Te6edf3AirQualityIndexTb4b4b4.Te6edf3computeNowCastPm25Tb4b4b4(Te6edf3readingsTb4b4b4, Te6edf3nowSecondsTb4b4b4) Tff7b72?: Tff7b72return Tff7b72null

Tff7b72val Te6edf3aqiValue Tff7b72= Te6edf3AirQualityIndexTb4b4b4.Te6edf3pm25ToAqiTb4b4b4(Te6edf3nowCastPm25Tb4b4b4)

Tff7b72return Te6edf3PmAqiSeverityTb4b4b4.Te6edf3fromAqiTb4b4b4(Te6edf3aqiValueTb4b4b4)Tff7b72?.Te6edf3let Tb4b4b4{ Te6edf3aqiValue Te6edf3to Tffa657it Tb4b4b4}

Tb4b4b4}

Tff7b72private Tff7b72fun Td2a8ffbuildAirQualityCardsTb4b4b4(

Te6edf3metricsTb4b4b4: Te6edf3AirQualityMetricsTb4b4b4,

Te6edf3aqiTextTb4b4b4: Tffa657String?Tb4b4b4,

Te6edf3ugm3Tb4b4b4: Tffa657StringTb4b4b4,

Te6edf3ppmUnitTb4b4b4: Tffa657StringTb4b4b4,

Te6edf3iconTb4b4b4: Te6edf3ImageVectorTb4b4b4,

Te6edf3tempIconTb4b4b4: Te6edf3ImageVectorTb4b4b4,

Te6edf3humidityIconTb4b4b4: Te6edf3ImageVectorTb4b4b4,

Te6edf3isFahrenheitTb4b4b4: Tffa657BooleanTb4b4b4,

Tb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3MetricGroupTff7b72> Tff7b72= Te6edf3buildList Tb4b4b4{

T8b949e// A present reading of 0 is a valid value (e.g. clean air at 0 µg/m³), so only the `?.` null-check (an

T8b949e// absent metric) hides a card — matching the #5793 chart/CSV zero-suppression fix.

Te6edf3metricsTb4b4b4.Te6edf3pm10_standardTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3pm Tff7b72-Tff7b72> Te6edf3addTb4b4b4(Te6edf3VectorMetricInfoTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3pm1_0Tb4b4b4, Ta5d6ff"Tffd700$Te6edf3pmTa5d6ff Tffd700$Te6edf3ugm3Ta5d6ff"Tb4b4b4, Te6edf3iconTb4b4b4)Tb4b4b4.Te6edf3asGroupTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4}

Te6edf3metricsTb4b4b4.Te6edf3pm25_standardTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3pm Tff7b72-Tff7b72>

Te6edf3addTb4b4b4(

Te6edf3listOfNotNullTb4b4b4(

Te6edf3VectorMetricInfoTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3pm2_5Tb4b4b4, Ta5d6ff"Tffd700$Te6edf3pmTa5d6ff Tffd700$Te6edf3ugm3Ta5d6ff"Tb4b4b4, Te6edf3iconTb4b4b4)Tb4b4b4,

T8b949e// AQI is derived from the raw PM2.5 reading, so it stacks directly under it — and is only shown when

T8b949e// that raw reading is present.

Te6edf3aqiTextTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3VectorMetricInfoTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3aqiTb4b4b4, Tffa657itTb4b4b4, Te6edf3iconTb4b4b4) Tb4b4b4}Tb4b4b4,

Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Te6edf3metricsTb4b4b4.Te6edf3pm100_standardTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3pm Tff7b72-Tff7b72> Te6edf3addTb4b4b4(Te6edf3VectorMetricInfoTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3pm10Tb4b4b4, Ta5d6ff"Tffd700$Te6edf3pmTa5d6ff Tffd700$Te6edf3ugm3Ta5d6ff"Tb4b4b4, Te6edf3iconTb4b4b4)Tb4b4b4.Te6edf3asGroupTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4}

T8b949e// The SCD4x CO₂ sensor also reports its own temperature/humidity (#5873) — surfaced here so a node can double as a

T8b949e// weather station without a separate BME sensor. All three come from that one sensor, so they share a column.

T8b949e// `?.` hides only genuinely-absent readings.

Te6edf3addTb4b4b4(

Te6edf3listOfNotNullTb4b4b4(

Te6edf3metricsTb4b4b4.Te6edf3co2Tff7b72?.Te6edf3let Tb4b4b4{ Te6edf3co2 Tff7b72-Tff7b72> Te6edf3VectorMetricInfoTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3co2Tb4b4b4, Ta5d6ff"Tffd700$Te6edf3co2Ta5d6ff Tffd700$Te6edf3ppmUnitTa5d6ff"Tb4b4b4, Te6edf3iconTb4b4b4) Tb4b4b4}Tb4b4b4,

Te6edf3metricsTb4b4b4.Te6edf3co2_temperatureTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3temp Tff7b72-Tff7b72>

Te6edf3VectorMetricInfoTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3co2_temperatureTb4b4b4, Te6edf3tempTb4b4b4.Te6edf3toTempStringTb4b4b4(Te6edf3isFahrenheitTb4b4b4)Tb4b4b4, Te6edf3tempIconTb4b4b4)

Tb4b4b4}Tb4b4b4,

Te6edf3metricsTb4b4b4.Te6edf3co2_humidityTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3hum Tff7b72-Tff7b72>

Te6edf3VectorMetricInfoTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3co2_humidityTb4b4b4, Ta5d6ff"Tffd700${Te6edf3NumberFormatterTb4b4b4.Te6edf3formatTb4b4b4(Te6edf3humTb4b4b4, T79c0ff0Tb4b4b4)Tffd700}Ta5d6ff%Ta5d6ff"Tb4b4b4, Te6edf3humidityIconTb4b4b4)

Tb4b4b4}Tb4b4b4,

Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

T8b949e/**

* Severity color for a metric's value text, or null to keep the default card color. The AQI tone is resolved by the

* caller because [PmAqiSeverity.color] is `@Composable`.

*/

Tff7b72private Tff7b72fun Td2a8ffmetricValueColorTb4b4b4(Te6edf3labelTb4b4b4: Te6edf3StringResourceTb4b4b4, Te6edf3co2ColorTb4b4b4: Te6edf3Color?Tb4b4b4, Te6edf3aqiColorTb4b4b4: Te6edf3Color?Tb4b4b4)Tb4b4b4: Te6edf3Color? Tff7b72= Tff7b72when Tb4b4b4(Te6edf3labelTb4b4b4) Tb4b4b4{

Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3co2 Tff7b72-Tff7b72> Te6edf3co2Color

Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3aqi Tff7b72-Tff7b72> Te6edf3aqiColor

Tff7b72else Tff7b72-Tff7b72> Tff7b72null

Tb4b4b4}

T8b949e/**

* Displays air quality info cards for a node showing PM1.0, PM2.5, PM10 and CO₂ values. A card is shown for each metric

* the node actually reports; a present reading of 0 (e.g. clean air at 0 µg/m³) is a valid value and is shown — only

* absent metrics are hidden. CO₂ value text is color-coded by severity.

*

* When [pm25History] has enough recent readings for an EPA NowCast (design#54), an additional AQI card is shown

* alongside the raw PM2.5 card, color-coded by EPA severity category. Below that threshold, only the raw readings are

* shown — never a computed AQI from insufficient data.

*/

Tf0883e@Composable

Tff7b72internal Tff7b72fun Td2a8ffAirQualityInfoCardsTb4b4b4(

Te6edf3nodeTb4b4b4: Te6edf3NodeTb4b4b4,

Te6edf3pm25HistoryTb4b4b4: Te6edf3ListTff7b72<Te6edf3TelemetryTff7b72> Tff7b72= Te6edf3emptyListTb4b4b4(Tb4b4b4)Tb4b4b4,

Te6edf3isFahrenheitTb4b4b4: Tffa657Boolean Tff7b72= Tff7b72falseTb4b4b4,

Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3metrics Tff7b72= Te6edf3nodeTb4b4b4.Te6edf3airQualityMetrics

Tff7b72val Te6edf3ugm3 Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3micrograms_per_cubic_meterTb4b4b4)

Tff7b72val Te6edf3ppmUnit Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3ppmTb4b4b4)

Tff7b72val Te6edf3aqi Tff7b72= Te6edf3nowCastAqiTb4b4b4(Te6edf3pm25HistoryTb4b4b4)

T8b949e// The category name always accompanies the value, so the AQI card never relies on color alone.

Tff7b72val Te6edf3aqiText Tff7b72=

Te6edf3aqiTff7b72?.Te6edf3let Tb4b4b4{ Tb4b4b4(Te6edf3valueTb4b4b4, Te6edf3severityTb4b4b4) Tff7b72-Tff7b72>

Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3aqi_value_with_severityTb4b4b4, Te6edf3valueTb4b4b4, Te6edf3stringResourceTb4b4b4(Te6edf3severityTb4b4b4.Te6edf3labelResTb4b4b4)Tb4b4b4)

Tb4b4b4}

Tff7b72val Te6edf3icon Tff7b72= Te6edf3MeshtasticIconsTb4b4b4.Te6edf3AirQuality

Tff7b72val Te6edf3tempIcon Tff7b72= Te6edf3MeshtasticIconsTb4b4b4.Te6edf3Temperature

Tff7b72val Te6edf3humidityIcon Tff7b72= Te6edf3MeshtasticIconsTb4b4b4.Te6edf3Humidity

Tff7b72val Te6edf3cards Tff7b72=

Te6edf3rememberTb4b4b4(Te6edf3metricsTb4b4b4, Te6edf3aqiTextTb4b4b4, Te6edf3ugm3Tb4b4b4, Te6edf3ppmUnitTb4b4b4, Te6edf3iconTb4b4b4, Te6edf3tempIconTb4b4b4, Te6edf3humidityIconTb4b4b4, Te6edf3isFahrenheitTb4b4b4) Tb4b4b4{

Te6edf3buildAirQualityCardsTb4b4b4(Te6edf3metricsTb4b4b4, Te6edf3aqiTextTb4b4b4, Te6edf3ugm3Tb4b4b4, Te6edf3ppmUnitTb4b4b4, Te6edf3iconTb4b4b4, Te6edf3tempIconTb4b4b4, Te6edf3humidityIconTb4b4b4, Te6edf3isFahrenheitTb4b4b4)

Tb4b4b4}

Tff7b72if Tb4b4b4(Te6edf3cardsTb4b4b4.Te6edf3none Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3isNotEmptyTb4b4b4(Tb4b4b4) Tb4b4b4}Tb4b4b4) Tff7b72return

Tff7b72val Te6edf3co2Color Tff7b72= Te6edf3Co2SeverityTb4b4b4.Te6edf3fromPpmTb4b4b4(Te6edf3metricsTb4b4b4.Te6edf3co2 Tff7b72?: T79c0ff0Tb4b4b4)Tff7b72?.Te6edf3color

Tff7b72val Te6edf3aqiColor Tff7b72= Te6edf3aqiTff7b72?.Te6edf3secondTff7b72?.Te6edf3colorTb4b4b4(Tb4b4b4)

Te6edf3MetricCardFlowTb4b4b4(Te6edf3groups Tff7b72= Te6edf3cardsTb4b4b4, Te6edf3valueColor Tff7b72= Tb4b4b4{ Te6edf3metric Tff7b72-Tff7b72> Te6edf3metricValueColorTb4b4b4(Te6edf3metricTb4b4b4.Te6edf3labelTb4b4b4, Te6edf3co2ColorTb4b4b4, Te6edf3aqiColorTb4b4b4) Tb4b4b4}Tb4b4b4)

Tb4b4b4}